Release 10.1A: OpenEdge Development:
Messaging and ESB

acknowledgeAndForward procedure

Forwards and acknowledges a message in a single operation.

Syntax

PROCEDURE acknowledgeAndForward. DEFINE INPUT PARAMETER destinationName AS CHARACTER. DEFINE INPUT PARAMETER messageH AS HANDLE. DEFINE INPUT PARAMETER priority AS INTEGER. DEFINE INPUT PARAMETER timeToLive AS DECIMAL. DEFINE INPUT PARAMETER persistency AS CHARACTER.

Applies to

Message Consumer objects

Notes

This procedure applies inside a message event handler.
The session must be set to SINGLE_MESSAGE_ACKNOWLEDGE.
The procedure expects a destination queue name, the original message handle, and optional message-delivery properties. If the message-delivery properties are set to the Unknown value (?), the procedure uses the original values from the message.
If the procedure is not successful—for example, if the destination does not exist—the message is not acknowledged and eventually returns to the queue.

See also

acknowledgeAndForward procedure, setSingleMessageAcknowledgement procedure, getSingleMessageAcknowledgement function, setNoAcknowledge procedure, getNoAcknowledge function

For more information, see the "Message acknowledgement, forwarding, and recovery" section and the "Single-message acknowledgement" section.